docs: Add Sentry MCP error monitoring cookbook #8060

bdougie · 2025-10-01T23:07:54Z

Summary

Adds a comprehensive Sentry MCP error monitoring cookbook that aligns with existing PostHog and Netlify cookbooks.

Changes

New cookbook: /guides/sentry-mcp-error-monitoring.mdx
- OAuth authentication setup with Sentry MCP
- Quick Start vs Manual Setup workflow tabs
- AI-powered error analysis using Sentry's Seer
- GitHub Actions workflow for continuous monitoring (every 6 hours)
- Integration with GitHub CLI for issue creation
Navigation update: Added Sentry cookbook to docs.json Cookbooks section

Features

Automated error analysis and root cause detection
GitHub issue creation with suggested fixes
All CLI commands and endpoints grounded in official Sentry MCP docs
Consistent Mintlify components (Card, Steps, Tabs, Info, Warning, etc.)
Security best practices and troubleshooting guide

Testing

Verify cookbook appears in docs navigation
Test all Sentry MCP links resolve correctly
Validate GitHub Actions workflow syntax

🤖 Generated with Claude Code

Summary by cubic

Adds a Sentry MCP error monitoring cookbook that automates error analysis and opens actionable GitHub issues. Also adds the cookbook to the docs navigation.

New Features
- New guide: guides/sentry-mcp-error-monitoring.mdx
- Setup with Sentry MCP OAuth (plus STDIO token option) and Quick Start vs Manual Setup tabs
- Error analysis using Sentry Seer with prompts for grouping and prioritization
- GitHub issue creation via gh CLI with recommended labels and Sentry links
- GitHub Actions example for continuous monitoring (runs every 6 hours)
- Added to Cookbooks in docs.json

- Create comprehensive Sentry MCP cookbook following PostHog/Netlify structure - Add automated error analysis workflow with AI-powered root cause detection - Include GitHub Actions workflow for continuous error monitoring (runs every 6 hours) - Add cookbook to docs.json navigation in Cookbooks section - All links grounded in official Sentry documentation - Uses Mintlify components consistent with existing cookbooks 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>

docs/guides/sentry-mcp-error-monitoring.mdx

- Make sidebar title match page title - Focus on Sentry Issues only (remove references to Releases/Performance in learning section) - Remove all references to Sentry's Seer AI to avoid confusion - Simplify MCP configuration approach - Fix comment formatting in code blocks for better copy/paste - Consider PR creation instead of just issues (keeping issues for now as PRs need more context) Generated with [Continue](https://continue.dev) Co-Authored-By: Continue <[email protected]>

bdougie · 2025-10-02T22:30:58Z

✅ Patrick's Feedback Addressed

Thank you for the thorough review @Patrick-Erichsen! I've pushed a commit that addresses all your feedback:

Changes Made:

✅ Fixed sidebar title - Now matches the page title "Automated Error Analysis with Sentry MCP"
✅ Focused on Issues only - Removed references to Releases and Performance monitoring in the learning objectives section, keeping the focus solely on Sentry Issues as suggested
✅ Removed all Sentry Seer AI references - Eliminated the confusion about "using Continue AI to use another AI product" by removing all mentions of Sentry's Seer AI throughout the document
✅ Cleaned up code block comments - Fixed the bash comment formatting that was preventing clean copy/paste functionality
✅ Simplified MCP configuration - Streamlined to follow standard MCP patterns

Note on PR vs Issue Creation:

Regarding your suggestion about creating PRs with fixes instead of issues - this is a great idea! For this initial cookbook, I've kept it as issue creation because automatic PR generation with meaningful fixes would require:

Deep context about the specific codebase structure
Access to the actual error context and surrounding code
More sophisticated code generation capabilities

This would be an excellent enhancement for a v2 of this cookbook once we have better codebase understanding capabilities integrated.

The whitespace issue in the rendering should also be resolved with these changes.

All changes have been pushed to the branch. Please let me know if you'd like any additional adjustments!

- Add Sentry MCP error monitoring cookbook to the MCP Integration section - Add dlt data pipelines cookbook to the MCP Integration section - Maintain alphabetical ordering within the MCP cookbook list Generated with [Continue](https://continue.dev) Co-Authored-By: Continue <[email protected]>

- Added Quick Start section similar to PostHog guide - Featured continuedev/sentry-continuous-ai agent from Continue Hub - Improved messaging and structure for faster onboarding - Updated Agent Requirements accordion with Pro Plan option - Fixed table formatting with left-aligned columns - Aligned GitHub CLI vs MCP messaging with PostHog guide Generated with [Continue](https://continue.dev) Co-Authored-By: Continue <[email protected]>

- Reordered tabs in Step 1 to prioritize MCP configuration - Configure Sentry MCP is now the leftmost tab for better visibility Generated with [Continue](https://continue.dev) Co-Authored-By: Continue <[email protected]>

- Added clarification that STDIO mode is for local development or self-hosted Sentry - Included environment variable configuration option (SENTRY_ACCESS_TOKEN, SENTRY_HOST) - Added Info box explaining --host parameter requirement with examples - Matches official Sentry MCP documentation Generated with [Continue](https://continue.dev) Co-Authored-By: Continue <[email protected]>

- SVG icon not rendering properly, using emoji fallback - Matches PostHog guide formatting Generated with [Continue](https://continue.dev) Co-Authored-By: Continue <[email protected]>

- Let rocket icon handle the visual representation - Cleaner appearance without duplicate visual elements Generated with [Continue](https://continue.dev) Co-Authored-By: Continue <[email protected]>

- Integrated Sentry Release GitHub Action for release tracking - Enhanced workflow to create Sentry releases on push to main - Updated Continue CLI prompt to generate comprehensive AI-powered issue descriptions - Added SENTRY_PROJECT to required secrets - Improved workflow summary with GitHub Step Summary - Added documentation on combining Sentry releases with Continue CLI - Link to official Sentry GitHub Actions documentation Generated with [Continue](https://continue.dev) Co-Authored-By: Continue <[email protected]>

github-actions · 2025-10-02T23:28:10Z

⚠️ PR Title Format

Your PR title doesn't follow the conventional commit format, but this won't block your PR from being merged. We recommend using this format for better project organization.

Expected Format:

<type>[optional scope]: <description>

Examples:

feat: add changelog generation support
fix: resolve login redirect issue
docs: update README with new instructions
chore: update dependencies

Valid Types:

feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert

This helps with:

📝 Automatic changelog generation
🚀 Automated semantic versioning
📊 Better project history tracking

This is a non-blocking warning - your PR can still be merged without fixing this.

github-actions · 2025-10-02T23:28:56Z

✅ Review Complete

⚠️ AI review completed but no review output was generated.

Likely cause: Expired CONTINUE_API_KEY or missing continuedev/review-bot assistant

📋 View workflow logs for details.

- Changed sidebarTitle from 'Automated Error Analysis with Sentry MCP' to 'Sentry Automated Error Analysis with MCP' - Improves discoverability by having Sentry as the first word Generated with [Continue](https://continue.dev) Co-Authored-By: Continue <[email protected]>

bdougie · 2025-10-02T23:30:24Z

Updated the sidebar title to have "Sentry" as the first word for SEO and sitemap optimization. This ensures better discoverability and aligns with our partnership strategy - having the partner product name first in navigation helps with both user discovery and search engine indexing.

cubic-dev-ai

1 issue found across 3 files

Prompt for AI agents (all 1 issues)


Understand the root cause of the following 1 issues and fix them.


<file name="docs/guides/sentry-mcp-error-monitoring.mdx">

<violation number="1" location="docs/guides/sentry-mcp-error-monitoring.mdx:424">
The Sentry token scopes listed here omit `project:releases`, but the workflow above calls `getsentry/action-release@v1`, which requires that scope to create releases. Add `project:releases` so readers don’t end up with a failing workflow.</violation>
</file>

_{React with 👍 or 👎 to teach cubic. Mention @cubic-dev-ai to give feedback, ask questions, or re-run the review.}

docs/guides/sentry-mcp-error-monitoring.mdx

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>

Resolved conflicts by keeping all cookbook entries

sestinj · 2025-10-08T15:36:29Z

🎉 This PR is included in version 1.27.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

sestinj · 2025-10-12T23:57:41Z

🎉 This PR is included in version 1.24.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

sestinj · 2025-10-15T06:55:33Z

🎉 This PR is included in version 1.2.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

github-project-automation bot added this to Issues and PRs Oct 1, 2025

github-project-automation bot moved this to Todo in Issues and PRs Oct 1, 2025

mintlify bot deployed to staging - docs October 1, 2025 23:08 View deployment

bdougie commented Oct 2, 2025

View reviewed changes

docs/guides/sentry-mcp-error-monitoring.mdx Show resolved Hide resolved

Patrick-Erichsen reviewed Oct 2, 2025

View reviewed changes

mintlify bot deployed to staging - docs October 2, 2025 22:31 View deployment

mintlify bot deployed to staging - docs October 2, 2025 22:38 View deployment

bdougie and others added 3 commits October 2, 2025 16:11

Move Configure Sentry MCP tab to first position

a47cf52

- Reordered tabs in Step 1 to prioritize MCP configuration - Configure Sentry MCP is now the leftmost tab for better visibility Generated with [Continue](https://continue.dev) Co-Authored-By: Continue <[email protected]>

mintlify bot deployed to staging - docs October 2, 2025 23:16 View deployment

Add rocket emoji back to Card title

63385e2

- SVG icon not rendering properly, using emoji fallback - Matches PostHog guide formatting Generated with [Continue](https://continue.dev) Co-Authored-By: Continue <[email protected]>

mintlify bot deployed to staging - docs October 2, 2025 23:20 View deployment

Remove rocket emoji from Card title

02ac1ba

- Let rocket icon handle the visual representation - Cleaner appearance without duplicate visual elements Generated with [Continue](https://continue.dev) Co-Authored-By: Continue <[email protected]>

mintlify bot deployed to staging - docs October 2, 2025 23:22 View deployment

mintlify bot deployed to staging - docs October 2, 2025 23:25 View deployment

bdougie marked this pull request as ready for review October 2, 2025 23:28

bdougie requested a review from a team as a code owner October 2, 2025 23:28

bdougie requested review from tingwai and removed request for a team October 2, 2025 23:28

dosubot bot added the size:XL This PR changes 500-999 lines, ignoring generated files. label Oct 2, 2025

mintlify bot deployed to staging - docs October 2, 2025 23:29 View deployment

cubic-dev-ai bot reviewed Oct 2, 2025

View reviewed changes

docs/guides/sentry-mcp-error-monitoring.mdx Outdated Show resolved Hide resolved

bdougie changed the title ~~Add Sentry MCP error monitoring cookbook~~ docs: Add Sentry MCP error monitoring cookbook Oct 2, 2025

Update sentry-mcp-error-monitoring.mdx

1d3ea01

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>

mintlify bot deployed to staging - docs October 2, 2025 23:42 View deployment

bdougie requested a review from BekahHW October 3, 2025 23:17

Merge branch 'main' into bdougie/con-4165

4b19659

Resolved conflicts by keeping all cookbook entries

mintlify bot deployed to staging - docs October 6, 2025 18:24 View deployment

Patrick-Erichsen approved these changes Oct 6, 2025

View reviewed changes

github-project-automation bot moved this from Todo to In Progress in Issues and PRs Oct 6, 2025

dosubot bot added the lgtm This PR has been approved by a maintainer label Oct 6, 2025

bdougie merged commit 54ba728 into main Oct 6, 2025
53 of 57 checks passed

bdougie deleted the bdougie/con-4165 branch October 6, 2025 21:18

github-project-automation bot moved this from In Progress to Done in Issues and PRs Oct 6, 2025

github-actions bot locked and limited conversation to collaborators Oct 6, 2025

sestinj added the released label Oct 8, 2025

docs: Add Sentry MCP error monitoring cookbook #8060

docs: Add Sentry MCP error monitoring cookbook #8060

Uh oh!

Conversation

bdougie commented Oct 1, 2025 • edited by cubic-dev-ai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

Features

Testing

Summary by cubic

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

bdougie commented Oct 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Patrick's Feedback Addressed

Changes Made:

Note on PR vs Issue Creation:

Uh oh!

github-actions bot commented Oct 2, 2025

⚠️ PR Title Format

Expected Format:

Examples:

Valid Types:

Uh oh!

github-actions bot commented Oct 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

bdougie commented Oct 2, 2025

Uh oh!

cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

sestinj commented Oct 8, 2025

Uh oh!

sestinj commented Oct 12, 2025

Uh oh!

sestinj commented Oct 15, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

bdougie commented Oct 1, 2025 •

edited by cubic-dev-ai bot

Loading

bdougie commented Oct 2, 2025 •

edited

Loading

github-actions bot commented Oct 2, 2025 •

edited

Loading